home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr28 / shinst11.zip / SHINST.DOC < prev    next >
Text File  |  1995-02-28  |  23KB  |  592 lines
  1.  
  2.   
  3.   
  4.   
  5.   
  6.   The Shareware Installer  v1.1 
  7.  ────────────────────────────────────────────────────────────────────────────
  8.   (C) Copyright 1995 Relative Software Innovations. All Rights Reserved.
  9.  
  10.   
  11.               
  12.                    
  13.  
  14.               
  15.               
  16.              ┌───────────────────────────────┐
  17.              │ @@@@@@@@@          @@@@@@@@   │
  18.              │  @@@   @@@        @@@@   @@@  │        
  19.              │  @@@    @@@      @@@      @@@ │        
  20.              │  @@@   @@@        @@@         │        
  21.              │  @@@@@@@@          @@@@@@@@   │        
  22.              │  @@@  @@@                @@@  │        
  23.              │  @@@   @@@       @@@      @@@ │        
  24.              │  @@@    @@@       @@@    @@@  │        
  25.              │ @@@@@  @@@@@       @@@@@@@@   │        
  26.              │            @@@@@@@            │        
  27.              │              @@@              │        
  28.              │              @@@              │        
  29.              │              @@@              │        
  30.              │              @@@              │        
  31.              │              @@@              │        
  32.              │              @@@              │        
  33.              │              @@@              │        
  34.              │            @@@@@@@            │        
  35.              └───────────────────────────────┘        
  36.                
  37.                Relative Software Innovations            
  38.             1515 N. Town East Blvd., Suite #138         
  39.                Mesquite, Texas 75150                
  40.                   (214) 681-8131                    
  41.              Compuserve ID  73611,127
  42.            
  43.            
  44.            BBS Support:
  45.            We maintain an RSI BBS on BBS AMERICA.
  46.              
  47.              BBS AMERICA - Dallas, Tx
  48.                (214)680-1451 - 9600bps V32
  49.                (214)680-3406 - 9600bps V32
  50.          (214)994-0093 - 2400bps(rollover lines)
  51.               FIDO NET: 124/6506
  52.         
  53.         At the BBS America Main Menu,  Select 4 for support BBS. 
  54.         At the Support BBS Main Menu,  Select R for the RSI BBS.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.     
  61.   The Shareware Installer v1.1                                        1 of 9
  62.  ────────────────────────────────────────────────────────────────────────────
  63.  
  64.    WARRANTY
  65.  
  66.      Relative Software Innovations specifically disclaims all warranties,
  67.    expressed or implied, including but not limited to implied warranties
  68.    of merchantability and fitness for a particular purpose.
  69.  
  70.      Your sole and exclusive remedy in the event of a defective diskette
  71.    is expressly limited to replacement of the diskette. If the diskette
  72.    should fail, return it to RSI with a brief statement describing the
  73.    defect.
  74.  
  75.      Relative Software Innovations shall not be liable for indirect,
  76.    special, incidental or consequential damages resulting from the use
  77.    of this product.
  78.  
  79.  
  80.    THE SHAREWARE CONCEPT
  81.  
  82.      The Shareware Installer is distributed as shareware. Shareware is com-
  83.    mercial software distributed in an unconventional manner. Microcomputers 
  84.    copy information very easily. Instead of trying to frustrate this through 
  85.    copy protection, shareware takes advantage of it to reach as many users 
  86.    as possible at the lowest cost. Anyone may copy a shareware program and 
  87.    distribute it to whomever they desire, provided they do not charge a 
  88.    fee for the program or alter it.
  89.  
  90.      Shareware isn't free. Serious shareware is as polished as any
  91.    conventional commercial product, and represents just as much program-
  92.    ming effort. If you use it regularly, the authors expect compensation.
  93.  
  94.      However, unlike conventional distribution, shareware allows you to 
  95.    evaluate the product before you decide to purchase it. The price is 
  96.    often lower, as well, because there are no advertising, packaging, or 
  97.    distribution costs.
  98.  
  99.      It can only work with your support. If you are still using a share-
  100.    ware product after a couple of weeks, then it is obviously worth some-
  101.    thing to you, and you should register it.
  102.  
  103.  
  104.    ABOUT THE SHAREWARE INSTALLER
  105.      
  106.      The Shareware Installer is a small, fast, and easy to use installation
  107.    program for software developers, programmers, and anyone who distributes  
  108.    software files. Although the name says shareware, it is excellent for all 
  109.    types of software installation, including commercial and custom software 
  110.    as well as for distributing data, graphics, and other files.
  111.    
  112.  
  113.  
  114.  
  115.  ────────────────────────────────────────────────────────────────────────────
  116.         
  117.         (c) Copyright 1995 Relative Software Innovations
  118.  
  119.     
  120.   The Shareware Installer v1.1                                        2 of 9
  121.  ────────────────────────────────────────────────────────────────────────────
  122.  
  123.    INTRODUCTION
  124.      
  125.      Thank you for evaluating The Shareware Installer! It is quite simple to
  126.    use and is easily customizable. The main files you should have are:
  127.  
  128.     SHINST.EXE -  The file you copy to the first disk to install the
  129.               software programs to your users disk media. You
  130.               may rename this file anything you wish (INSTALL.EXE,
  131.               GO.EXE, RUN.EXE, etc.). 
  132.  
  133.     INSTALL.INF - The script file that SHINST.EXE reads. DO NOT RENAME
  134.               THIS FILE. The EXE file looks for this file and will
  135.               not run if it cannot find it.
  136.  
  137.      
  138.      The Shareware Installer will extract self-extracting EXE files or ZIP 
  139.    archive files using PKUNZIP. You need to you make sure that you have 
  140.    a license to distribute self-extracting EXE files for the utility 
  141.    you are using. PKWare requires you have a license to distribute self-
  142.    extracting EXE files since it includes an unzipping program in the EXE 
  143.    header. PKWare also requires a license to distribute PKUNZIP.EXE
  144.      
  145.    WARNING: If you will be distributing self-extracting archives with your
  146.    installation disks, you may want to leave the BACKGROUND switch OFF. If
  147.    the user tries to reinstall a file group that includes a self-extracting
  148.    EXE file, the archive will prompt to overwrite the existing files. If 
  149.    the BACKGROUND switch is ON (meaning the files are installed in the back-
  150.    ground, unseen by the user) the prompt will not be seen and the user will 
  151.    think the program is locked up. The files installed from ZIP files will
  152.    automatically overwrite existing files.
  153.    
  154.      
  155.    
  156.    SET-UP
  157.  
  158.      To create a disk or disk set for distribution, copy the SHINST.EXE and 
  159.    INSTALL.INF to Disk #1. You can rename SHINST.EXE (INSTALL.EXE, GO.EXE, 
  160.    etc.) as long as you don't rename INSTALL.INF. 
  161.    
  162.      Next, copy the ZIP and/or EXE archive files to the disks. Copy the 
  163.    files to make the best use of the disk space on each disk. Then, list the 
  164.    disk numbers and file names in the INSTALL.INF file on Disk #1 along with 
  165.    the file description and total bytes needed for installation.
  166.    
  167.      Then copy PKUNZIP.EXE to each disk in the set that contains zip 
  168.    files.
  169.    
  170.      You can include up to 5 subprograms along with the main programs files.
  171.    Each subprogram (including the main program) can include up to 5 archive 
  172.  
  173.  
  174.  ────────────────────────────────────────────────────────────────────────────
  175.         
  176.         (c) Copyright 1995 Relative Software Innovations
  177.  
  178.     
  179.   The Shareware Installer v1.1                                        3 of 9
  180.  ────────────────────────────────────────────────────────────────────────────
  181.    
  182.    files for a maximum of 30 archive files per installation. See the sample 
  183.    INSTALL.INF file included with The Shareware Installer for an example of 
  184.    the MyGraphics Program installation script.
  185.    
  186.    
  187.    INSTALL.INF
  188.  
  189.      The data in the INSTALL.INF file is read by the SHINST.EXE file while
  190.    the program is loading. You can set the foreground and background colors
  191.    for the background screen and the display windows. You can also enter a
  192.    fill character value for the background screen. Set the BACKGROUND switch
  193.    to OFF to show the installing of the archives on the display screen.
  194.    
  195.    
  196.    NOTE: During testing it is best to run with BACKGROUND = OFF so you can
  197.    see the files being installed and make sure everything is being installed
  198.    correctly. 
  199.    
  200.      
  201.      The syntax for the first switches are:
  202.  
  203.    BackGround = On
  204.    CPURequired = 286
  205.    DosVerRequired = 320
  206.    VideoRequired = 4
  207.    ConvMemRequired = 400
  208.    ExtMemRequired = 0
  209.    
  210.  
  211.    Switch               Value                                               
  212.    -------------------------------------------------------------------------
  213.    Background           On or Off.                
  214.                           
  215.    CPURequired          86, 286, 386, or 486.     
  216.                           
  217.    DosVerRequired       320 is for version 3.20, 600 is version 6.00, etc.
  218.             DO NOT use a decimal. The program will format and
  219.             display the DOS version correctly after it checks
  220.             it against the installed value.
  221.                           
  222.    VideoRequired        0 - 11. See VIDEO CARD AND MONITOR CHART on page 9.
  223.    
  224.    ConvMemRequired      Number K bytes required to run the program. 400 is 
  225.             400,000 bytes of memory.
  226.    
  227.    ExtMemRequired       Number K bytes of extended memory required. 1000 is
  228.             1 mb.
  229.       
  230.      
  231.  
  232.  
  233.  ────────────────────────────────────────────────────────────────────────────
  234.         
  235.         (c) Copyright 1995 Relative Software Innovations
  236.  
  237.     
  238.   The Shareware Installer v1.1                                        4 of 9
  239.  ────────────────────────────────────────────────────────────────────────────
  240.    
  241.      The next set of switches are enclosed into either the SCREEN or WINDOW
  242.    sections of the script file so that both the foreground and background
  243.    colors for each can be set. See FOREGROUND AND BACKGROUND COLOR CHART on 
  244.    page 7 and SCREEN FILLCHARACTER CHART on page 8.
  245.  
  246.                                       
  247.    [SCREEN]                                                               
  248.    Foreground = Gray                                                      
  249.    Background = White                                                     
  250.    FillCharacter = 176
  251.    [END]
  252.    [WINDOW]
  253.    Foreground = White
  254.    Background = Blue
  255.    [END]
  256.  
  257.    
  258.    NOTE: All the section headers listed in brackets ([]) must be entered 
  259.    exactly as shown so the SHINST.EXE file reads in the variables correctly. 
  260.  
  261.      
  262.      
  263.      Next are the main files and sub files sections. The main files section
  264.    lists the program information for the main part of the program. If you do
  265.    not have any sub or optional files to install, then this section will be
  266.    the only one you need to fill in. The sub files section is identical to
  267.    the main files section in syntax. 
  268.    
  269.      The first line is for the program name and description (up to 50 char-
  270.    acters) and the disk space required of all the files in the main program 
  271.    after they have been unzipped. The information on each line is separated 
  272.    by an asterisk (*). The program reads in the first line and reads the 
  273.    program name/description and the total bytes needed.
  274.    
  275.      The second line tells the program the disk number and file name of each 
  276.    of the archive files needed to install the main program. You can list up 
  277.    to 5 archive files for the main files and for each sub file group. 
  278.    
  279.      The third line is the default drive and directory to install the program 
  280.    to. The Syntax is:
  281.    
  282.    
  283.    [MAINFILES]
  284.    MyGraphics Program - Includes Fonts, Clipart, & MORE * 550000
  285.    1 * mygraph1.exe * 1 * mygraph2.exe * 2 * mygraph3.zip
  286.    c:\mygraph
  287.    [END]
  288.  
  289.    
  290.  
  291.  
  292.  ────────────────────────────────────────────────────────────────────────────
  293.         
  294.         (c) Copyright 1995 Relative Software Innovations
  295.  
  296.     
  297.   The Shareware Installer v1.1                                        5 of 9
  298.  ────────────────────────────────────────────────────────────────────────────
  299.      
  300.      The syntax for the sub files is identical to the main files except you 
  301.    can list up to 5 sub file groups, each with up to 5 archive files. That's 
  302.    a maximum of 30 archive files for each program you want to distribute. The 
  303.    sub files default path can be the same as the main files or a it can be a 
  304.    subdirectory of the main files directory. If the default path is changed 
  305.    by the user then the subfiles path will be changed also. 
  306.    
  307.      For example, if the default path was C:\MYGRAPHICS and the font package 
  308.    default path was C:\MYGRAPHICS\FONTS and the user changed the path to be
  309.    D:\MG then the fonts path would be changed to D:\MG\FONTS. 
  310.      
  311.      The syntax for the sub files section is:  
  312.    
  313.    
  314.    [SUBFILES]
  315.    MyGraphics Font Package * 350000
  316.    2 * mgfonts.zip
  317.    c:\mygraph\fonts
  318.  
  319.    MyGraphics Clipart Package * 1200000
  320.    2 * mgclart1.zip * 3 * mgclart2.zip
  321.    c:\mygraph\clipart
  322.  
  323.    MyGraphics Printer Drivers * 90000
  324.    2 * mgprtdrv.zip
  325.    c:\mygraph
  326.    [END]
  327.  
  328.  
  329.      The blank line between each group is for clarity only. They can be re-
  330.    moved before distributing the file.
  331.    
  332.  
  333.  
  334.      The next sections are for the AUTOEXEC.BAT and CONFIG.SYS files. You
  335.    can include up to 5 lines that may need to be added or increased in each 
  336.    of the files. They will be presented to the user and they will have an 
  337.    opportunity to modify the files. If you do not have anything that needs 
  338.    to be added, you can remove the section from the file or place the [END] 
  339.    on the next line as shown in the first section below. The syntax is:
  340.  
  341.  
  342.    [AUTOEXEC.BAT]
  343.    [END]
  344.  
  345.    [CONFIG.SYS]
  346.    FILES = 15
  347.    BUFFERS = 20
  348.    [END]
  349.  
  350.  
  351.  ────────────────────────────────────────────────────────────────────────────
  352.         
  353.         (c) Copyright 1995 Relative Software Innovations
  354.  
  355.     
  356.   The Shareware Installer v1.1                                        6 of 9
  357.  ────────────────────────────────────────────────────────────────────────────
  358.  
  359.      The RUNCOMMAND section allows you to place one line containing a file
  360.    name or DOS command to be run after the installation is completed. If 
  361.    there are several commands that need to be run when your program is 
  362.    loaded, place them in a batch file and install it with your main program
  363.    files. Then enter the name of the batch file in the RUNCOMMAND section.
  364.    If you wish to display a text file and included a file viewer such as 
  365.    LIST.EXE in with your main files, you could display the text file READ.ME 
  366.    by placing LIST READ.ME in the RUNCOMMAND section. The syntax is:
  367.  
  368.    
  369.    [RUNCOMMAND]
  370.    mygraph.exe
  371.    [END]
  372.    
  373.      
  374.      
  375.      The Intro, Install, and Exit message sections are for listing text
  376.    to be displayed in those windows. Up to 18 lines can be entered in each
  377.    window. Blank lines can be inserted anywhere in the text but only the 
  378.    first 18 lines will be read. 
  379.      
  380.      The syntax for the message sections are:  
  381.  
  382.    
  383.    [INTROTEXT]
  384.     
  385.        The Shareware Installer - Software Distribution Made Easy!
  386.  
  387.      Thank you for evaluating this program. Although the name is The
  388.     Shareware Installer, it's perfect for shareware, commercial, and
  389.     custom software installation as well as the installation of data,
  390.     graphics, and other files. Software developers, programmers, and
  391.     anyone distributing files can edit the sample INSTALL.INF file
  392.     and create a distribution disk (or set) quickly and easily.
  393.  
  394.      FEATURES: Personalized Intro, Install, and Exit messages; edit
  395.     screen/window colors; user selectable file groups for partial
  396.     installation, upgrades, etc.; disk space check; conventional and
  397.     extended memory check; DOS version check; CPU check; video card
  398.     and monitor check; supports multiple disks and files; optionally
  399.     modify AUTOEXEC.BAT and CONFIG.SYS files; installs self-extract-
  400.     ing EXE files or ZIP files using PKUNZIP; and MUCH, MUCH, MORE!
  401.  
  402.    [END]
  403.    
  404.    [INSTALLTEXT]
  405.    
  406.      You can display up to 18 lines of information in each of the
  407.     text message screens.
  408.  
  409.  
  410.  ────────────────────────────────────────────────────────────────────────────
  411.         
  412.         (c) Copyright 1995 Relative Software Innovations
  413.  
  414.     
  415.   The Shareware Installer v1.1                                        7 of 9
  416.  ────────────────────────────────────────────────────────────────────────────
  417.  
  418.      The Shareware Installer prompts for each disk required for
  419.     the selected files and displays the file name and destination
  420.     directory on the bottom of the screen as it is being installed
  421.     If you selected BACKGROUND = OFF, the installation will run in
  422.     the foreground and the user will see the files listed on the
  423.     screen as they are being unzipped.
  424.  
  425.      If you included lines in the CONFIG.SYS and/or AUTOEXEC.BAT
  426.     sections, the user will have an option to edit those files.
  427.  
  428.    [END]
  429.    
  430.    [EXITTEXT]
  431.  
  432.      The Shareware Installer will exit to the default path. If you
  433.     entered a program, file name, or DOS command in the RunCommand
  434.     section, the selected file or command will be run upon exiting
  435.     the installation program.
  436.  
  437.      Thanks again for evaluating The Shareware Installer! You can
  438.     contact us at the address listed below:
  439.   
  440.        Relative Software Innovations
  441.        1515 N. Town East Blvd., Suite #138
  442.        Mesquite, Texas  75150-4149
  443.        Phone/Fax: (214) 681-8131
  444.        CIS ID: 73611,127
  445.        Contact: Steve Moore
  446.  
  447.    [END]
  448.      
  449.    
  450.    
  451.    FOREGROUND AND BACKGROUND COLOR CHART
  452.      
  453.      Below is a list that show the valid names for the foreground
  454.    and background colors.
  455.  
  456.    Foreground Colors:                           Background Colors:
  457.    Normal       Bright                          
  458.    --------------------------------------------------------------------------
  459.    Black        BrBlue                          Black
  460.    Blue         BrGreen                         Blue
  461.    Green        BrCyan                          Green
  462.    Cyan         BrRed                           Cyan
  463.    Red          BrMagenta                       Red
  464.    Magenta      Yellow                          Magenta
  465.    Brown        BrWhite                         Brown
  466.    White                                        White
  467.    Gray   
  468.  
  469.  ────────────────────────────────────────────────────────────────────────────
  470.         
  471.         (c) Copyright 1995 Relative Software Innovations
  472.  
  473.     
  474.   The Shareware Installer v1.1                                        8 of 9
  475.  ────────────────────────────────────────────────────────────────────────────
  476.    
  477.    SCREEN FILLCHARACTER CHART
  478.  
  479.      Below is a list of fill character values and what they look like. 
  480.    Some ASCII characters are used by the PC as control codes (8, 10, 12,
  481.    13, etc.) and will cause unpredictable results when printing to a
  482.    printer or the screen (unless you print directly to display memory as
  483.    The Shareware Installer does). ASCII characters 9, 10 and 13 would not 
  484.    print to this file. ASCII value 9 is a thin circle and 10 is reverse 
  485.    of 9 (like 8 is reverse of 9). Number 13 is a single note similar to 
  486.    14's double. Number 32 is a space and can be used to display a solid 
  487.    background. 
  488.      
  489.      
  490.      1       2       3       4       5       6       7       8 
  491.      9       10       11       12       13       14      15      16 
  492.     17      18      19      20      21      22      23      24 
  493.     25      26      27      28      29      30      31      32  
  494.     33 !     34 "     35 #     36 $     37 %     38 &     39 '     40 (
  495.     41 )     42 *     43 +     44 ,     45 -     46 .     47 /     48 0
  496.     49 1     50 2     51 3     52 4     53 5     54 6     55 7     56 8
  497.     57 9     58 :     59 ;     60 <     61 =     62 >     63 ?     64 @
  498.     65 A     66 B     67 C     68 D     69 E     70 F     71 G     72 H
  499.     73 I     74 J     75 K     76 L     77 M     78 N     79 O     80 P
  500.     81 Q     82 R     83 S     84 T     85 U     86 V     87 W     88 X
  501.     89 Y     90 Z     91 [     92 \     93 ]     94 ^     95 _     96 `
  502.     97 a     98 b     99 c    100 d    101 e    102 f    103 g    104 h
  503.    105 i    106 j    107 k    108 l    109 m    110 n    111 o    112 p
  504.    113 q    114 r    115 s    116 t    117 u    118 v    119 w    120 x
  505.    121 y    122 z    123 {    124 |    125 }    126 ~    127     128 Ç
  506.    129 ü    130 é    131 â    132 ä    133 à    134 å    135 ç    136 ê
  507.    137 ë    138 è    139 ï    140 î    141 ì    142 Ä    143 Å    144 É
  508.    145 æ    146 Æ    147 ô    148 ö    149 ò    150 û    151 ù    152 ÿ
  509.    153 Ö    154 Ü    155 ¢    156 £    157 ¥    158 ₧    159 ƒ    160 á
  510.    161 í    162 ó    163 ú    164 ñ    165 Ñ    166 ª    167 º    168 ¿
  511.    169 ⌐    170 ¬    171 ½    172 ¼    173 ¡    174 «    175 »    176 ░
  512.    177 ▒    178 ▓    179 │    180 ┤    181 ╡    182 ╢    183 ╖    184 ╕
  513.    185 ╣    186 ║    187 ╗    188 ╝    189 ╜    190 ╛    191 ┐    192 └
  514.    193 ┴    194 ┬    195 ├    196 ─    197 ┼    198 ╞    199 ╟    200 ╚
  515.    201 ╔    202 ╩    203 ╦    204 ╠    205 ═    206 ╬    207 ╧    208 ╨
  516.    209 ╤    210 ╥    211 ╙    212 ╘    213 ╒    214 ╓    215 ╫    216 ╪
  517.    217 ┘    218 ┌    219 █    220 ▄    221 ▌    222 ▐    223 ▀    224 α
  518.    225 ß    226 Γ    227 π    228 Σ    229 σ    230 µ    231 τ    232 Φ
  519.    233 Θ    234 Ω    235 δ    236 ∞    237 φ    238 ε    239 ∩    240 ≡
  520.    241 ±    242 ≥    243 ≤    244 ⌠    245 ⌡    246 ÷    247 ≈    248 °
  521.    249 ∙    250 ·    251 √    252 ⁿ    253 ²    254 ■    255
  522.    
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  ───────────────────────────────────────────────────────────────────────────
  530.         
  531.         (c) Copyright 1995 Relative Software Innovations
  532.  
  533.     
  534.   The Shareware Installer v1.1                                        9 of 9
  535.  ────────────────────────────────────────────────────────────────────────────
  536.  
  537.    VIDEO CARD AND MONITOR CHART
  538.  
  539.     The VideoRequired switch accepts a number of 0 through 11 to set the
  540.   required video adapter and monitor. Below are the values and corresponding
  541.   meanings. 
  542.   
  543.     For example, VideoRequired = 7 means that a VGA w/Color Monitor is the 
  544.   minimum required for this particular program.
  545.  
  546.  
  547.   
  548.   Value      Means                           Value      Means     
  549.   --------------------------------------------------------------------------
  550.   0          Any Video Adapter               6          VGA w/Mono Monitor
  551.   1          Monochrome Adapter              7          VGA w/Color Monitor
  552.   2          Hercules Monochrome             8          MCGA w/Mono Monitor
  553.   3          CGA Adapter                     9          MCGA w/Color Monitor
  554.   4          EGA w/Mono Monitor              10         EGA w/CGA Monitor
  555.   5          EGA w/Color Monitor             11         IBM 8514/A
  556.   
  557.    
  558.    
  559.    
  560.    
  561.    COMMENTS, SUGGESTIONS, ETC.
  562.  
  563.      If you have any comments or suggestions, please feel free to write or
  564.    call us. Also, if you have any problems with The Shareware Installer, let
  565.    us know so we may be able to correct any problems for future updates.
  566.  
  567.                            Thank You.
  568.   
  569.    
  570.    
  571.  
  572.    
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  ───────────────────────────────────────────────────────────────────────────
  588.         
  589.         (c) Copyright 1995 Relative Software Innovations
  590.  
  591.  
  592.